Unit Events

N4 records the following events during unit handling process. Each event is recorded as per the use case mentioned in the Event Description column.

You can view each recorded event in the respective Business Entity Inspector view History, Events tab..

 

Event Name

Event Description

Business Entity

CAS_UNIT_CAPTURE

When a CAS captures unit details and updates the unit.

Unit

CAS_UNIT_POSITION_UPDATE

When a CAS sends unit position update.

Unit

CAS_UNIT_READY_TO_TRANSFER

When the UnitTransferAllowedValidator (system-seeded Code Extensions) with the extension type CTL_UNIT_TRANSFER_ALLOWED returns "TRUE", N4 sends a unit ready to transfer message to CAS and this event is recorded.

Unit

EMULATION_SCHEDULED_EXCEPTION_UNIT

When a scheduled exception is applied to a unit (emulation testing).

Unit

REEFER_SETTINGS_RECORDED

When you update the reefer requirements for a unit.

Unit

UNIT_ACCESSORY_BRING_BACK_INTO_YARD

When an accessory is brought back into the yard due to a canceled delivery gate transaction.

Unit

UNIT_ACCESSORY_BRING_TO_COMMUNITY

When an accessory is put back into the community due to a cancelled receive gate transaction.

Unit

UNIT_ACCESSORY_DELIVER

When an accessory is delivered to a truck.

Unit

UNIT_ACCESSORY_DELIVER_REJECTED

When an accessory is rejected by trucker and returned to yard.

Unit

UNIT_ACCESSORY_DRAY_IN

When an accessory is drayed-in.

Unit

UNIT_ACCESSORY_IFT_IN

When an accessory is Inter-facility Transfered In.

Unit

UNIT_ACCESSORY_IFT_OUT

When an accessory is Inter-facility Transfered Out.

Unit

UNIT_ACCESSORY_POSITION_CORRECTION

When an accessory position is updated.

Unit

UNIT_ACCESSORY_RECEIVE

When an accessory is received from a truck.

Unit

UNIT_ACCESSORY_REROUTE

When an accessory routing changed.

Unit

UNIT_ACCESSORY_RETURN_TO_INBOUND_CARRIER

When an accessory is returned back to its inbound carrier.

Unit

UNIT_ACCESSORY_SHIFT_ON_CARRIER

When an accessory is moved while on a carrier - such as a vessel.

Unit

UNIT_ACCESSORY_YARD_MOVE

When an accessory is moved in the yard.

Unit

UNIT_ACCESSORY_YARD_SHIFT

When an accessory is shifted in the yard in order to access another unit.

Unit

UNIT_ACTIVATE

When N4 initiates the process of unit activation after a new unit is created. Generally it will come soon after UNIT_CREATE.

Unit

UNIT_ALARM

When the reefer container alarm is set on.

Unit

UNIT_ATTACH_TO_ERO

When you successfully assign an ERO reference for a unit.

Unit

UNIT_BRING_BACK_INTO_YARD

When a unit is brought back into the yard due to a cancelled delivery gate transaction.

Unit

UNIT_BRING_TO_COMMUNITY

When a unit is moved back into the community in the following scenarios:

  • receival gate transaction is canceled

  • rectify the unit using the Rectify Units form

  • using Groovy or General Notices.

Unit

UNIT_BUNDLE

When the first payload is attached to a primary unit.

Unit

UNIT_BUNDLE_ADD

When an equipment is added to the bundle.

Unit

UNIT_BUNDLE_PAYLOAD_ADD

When the first Payload is attached to a Primary unit.

Unit

UNIT_BUNDLE_PAYLOAD_SWIPE

When a Payload is detached from the primary and the primary is no longer part of a bundle.

Unit

UNIT_CANCEL_PREADVISE

When the pre-advised unit is canceled.

Unit

UNIT_CANCEL_RESERVE

When the unit reservation for an order (Booking, IDO, Bill of Lading, or EDO) is canceled.

Unit

UNIT_CARRIAGE_BRING_BACK_INTO_YARD

When a carriage is brought back into the yard due to a canceled delivery gate transaction.

Unit

UNIT_CARRIAGE_BRING_TO_COMMUNITY

When a carriage is put back into the community due to a canceled receive gate transaction.

Unit

UNIT_CARRIAGE_DELIVER

When a carriage is delivered to a truck.

Unit

UNIT_CARRIAGE_DELIVER_REJECTED

When a carriage is rejected by trucker and returned to yard.

Unit

UNIT_CARRIAGE_DISMOUNT

When an chassis in yard is removed from the Container.

Unit

UNIT_CARRIAGE_DRAY_IN

When a carriage is drayed-in.

Unit

UNIT_CARRIAGE_IFT_IN

When a carriage is Inter-facility Transfered In.

Unit

UNIT_CARRIAGE_IFT_OUT

When a carriage is Inter-facility Transfered Out.

Unit

UNIT_CARRIAGE_MOUNT

When an chassis in yard is added to the Container.

Unit

UNIT_CARRIAGE_POSITION_CORRECTION

When a carriage position is updated.

Unit

UNIT_CARRIAGE_RECEIVE

When a carriage is received from a truck.

Unit

UNIT_CHS_ACCESSORY_DISMOUNT

When an accessory in the yard is removed from the chassis.

Unit

UNIT_CHS_ACCESSORY_MOUNT

When an accessory in the yard is added to the chassis.

Unit

UNIT_CREATE

  • When you create a unit

  • When you create a break-bulk unit.

Unit

UNIT_CTR_ACCESSORY_DISMOUNT

When an accessory in yard is removed from the Container.

Unit

UNIT_CTR_ACCESSORY_MOUNT

When an accessory in yard is added to the Container.

Unit

UNIT_DAMAGED

When you record a new damage to a unit.

Unit

UNIT_DAMAGES_DELETED

When a damaged unit is deleted.

Unit

UNIT_DAMAGES_UPDATED

When you update a new damage to an already damaged unit.

Unit

UNIT_DELIVER

When the CHE places the unit onto the Truck.

Unit

UNIT_DELIVER_REJECTED

When the unit was rejected by truck and returned to the yard. This event will be recorded if the Return to Yard checkbox is selected for the unit.

Unit

UNIT_DEPART

When the unit departed or in a Departed state.

Unit

UNIT_DISCH

When the unit is discharge from a vessel.

Unit

UNIT_DISCHLIST_EDI_CREATED

When unit is created from DischList EDI posting.

Unit

UNIT_DISCHLIST_EDI_UPDATED

When unit is updated by DischList EDI posting.

Unit

UNIT_DISMOUNT

When a primary unit is de-attached with a secondary equipment system.

Unit

UNIT_DOCUMENT_CREATE

When you create a new unit document in the Unit Document menu.

Unit

UNIT_DOCUMENT_DELETE

When you delete a unit document from the Unit Document menu.

Unit

UNIT_DOCUMENT_UPDATE

When you update a unit document in the Unit Document menu.

Unit

UNIT_DOOR_DIRECTION_CHANGED

When the unit door direction changes.

Unit

UNIT_DRAY_IN

When the unit returns to the facility.

Unit

UNIT_EQ_OWNER_OPERATOR_CHANGE

When you update the Equipment Owner or Equipment Operator fields for a unit. However, N4 does not record this event if the previous operator/owner was UNKN.

Unit

UNIT_EQUIPMENT_MEASURED_WEIGHT

When a unit’s yard measured weight is updated. You can refer this topic for more details.

Unit

UNIT_EVENT_PROPERTY_UPDATE

When you successfully update a unit event details in Unit Inspector > History, Events tab > Edit button > Edit Unit Event form.

Unit

UNIT_HAZARDS_DELETE

When unit hazard details are deleted for the selected unit.                                                                                 

Unit

UNIT_HAZARDS_INSERT

When unit hazards fields are created.If you set ARGOHAZARD002 to true, N4 records the UNIT_HAZARDS_INSERT event and records the changes that were made to any of the following fields:

  • IMDG Class

  • UN Number

  • Quantity

  • Weight (kg)

  • Flash Point (C)

  • Fire Code                                                                                                                                     

Unit

UNIT_HAZARDS_UPDATE

When the unit hazards fields are updated. If you set ARGOHAZARD002 to true, N4 records the UNIT_HAZARDS_UPDATE event and records the changes that were made to any of the following fields:

  • IMDG Class

  • UN Number

  • Quantity

  • Weight (kg)

  • Flash Point (C)

  • Fire Code                                                                                                                                     

Unit

UNIT_IFT_IN

When the unit is Inter-facility Transfered In.

Unit

UNIT_IFT_OUT

When the unit is Inter-facility Transfered Out.

Unit

UNIT_IGNORED_EDI

When the unit is not updated from an EDI posting.

Unit

UNIT_LINE_STORAGE_UPDATE

When you update the line operator details for the selected unit in the Update Storage form.

Unit

UNIT_LOADLIST_EDI_CREATED

When you successfully posted a LOADLIST EDI for a container that is not at the facility.

Unit

UNIT_LOADLIST_EDI_UPDATED

When you successfully posted a LOADLIST EDI for a container that is already at the facility.

Unit

UNIT_MERGE

When the unit is merged with another unit that was rerouted. For example: When you update the routing of an Active unit such that it matches the routing of an Advised unit in the same or different facility, N4 merges the Unit-level attributes for the two UFVs. It records the UNIT_MERGE event in the Event History of the two UFVs.

Unit

UNIT_MISIDENTIFIED

When the Crane Team UI flags unit as misidentified in the Flag Misidentified Unit form, this event is recorded along with the data that has been swapped.

Unit

UNIT_MOUNT

When a primary unit is attached with a secondary equipment system.

Unit

UNIT_NOTICE

When a general notice is triggered and sent against a unit event.

Unit

UNIT_OFFHIRE

When you record Off-hire On-hire transaction, N4 retires a unit and records this event against the unit.

Unit

UNIT_ONHIRE

When you record Off-hire On-hire transaction, N4 creates a new facility visit for the unit and this event is recorded against the unit.

Unit

UNIT_OPERATOR_CHANGE

When the line operator is updated for the selected unit.

Unit

UNIT_OVERDIMENSIONS_UPDATE

When the Unit Over Dimensions(oog) values are updated.

Unit

UNIT_PAYLOAD_BRING_BACK_INTO_YARD

When a payload brought back into the yard due to a canceled delivery gate transaction

Unit

UNIT_PAYLOAD_BRING_TO_COMMUNITY

When a payload is put back into the community due to a canceled receive gate transaction.

Unit

UNIT_PAYLOAD_DELIVER

When a payload is delivered to a truck.

Unit

UNIT_PAYLOAD_DELIVER_REJECTED

When a payload is rejected by trucker and returned to yard.

Unit

UNIT_PAYLOAD_DISCH/

UNIT_PAYLOAD_LOAD

When a payload is discharged/loaded from a vessel. Note: If you want N4 to extract payload events after the unit is detached form the primary unit, you will need to set ARGOEDI034 (EXTRACT_ALLOW_ATTACHED_UNIT_EVENT_AFTER_DETACH) (on page 1) to TRUE.

Unit

UNIT_PAYLOAD_DRAY_IN

When a payload drayed-in.

Unit

UNIT_PAYLOAD_IFT_IN

When a payload is Inter-facility Transfered In.

Unit

UNIT_PAYLOAD_IFT_OUT

When a payload is Inter-facility Transfered Out.

Unit

UNIT_PAYLOAD_POSITION_CORRECTION

When a payload position is updated.

Unit

UNIT_PAYLOAD_RECEIVE

When a payload is received from a truck.

Unit

UNIT_PAYLOAD_REROUTE

When a payload routing is changed.

Unit

UNIT_PAYLOAD_RETURN_TO_INBOUND_CARRIER

When a payload is returned back to its inbound carrier.

Unit

UNIT_PAYLOAD_ROLL

When a payload is rolled to another vessel.

Unit

UNIT_PAYLOAD_SHIFT_ON_CARRIER

When a payload is moved while on a carrier - such as a vessel.

Unit

UNIT_PIN_ASSIGNED

When you assign a PIN to a unit.

Unit

UNIT_POSITION_CORRECTION

  • When the unit position is updated through EDI Stowplan message post.

  • When you update the position of a unit using the Position/Orientation form.

Unit

UNIT_POWER_CONNECT

When the reefer container in the yard is disconnected or plugged in.

Unit

UNIT_POWER_DISCONNECT

When the reefer container in the yard is disconnected or unplugged.

Unit

UNIT_POWER_UPDATE

When you update the power details for the selected reefer unit in the Update Storage form.

Unit

UNIT_PREADVISE

When the unit is pre advised successfully.

Unit

UNIT_PROPERTY_UPDATE

When the unit physical status or other details are updated. You can refer this topic for more details about this event.

Unit

UNIT_RECEIVE

  • When the CHE places the unit into the yard.

  • When the unit is rejected by truck and returned to the yard. This event will be recorded if the Return to Yard checkbox is not selected for the unit.

Unit

UNIT_RECORD_DAMAGE

When damages are recorded against the unit.

Unit

UNIT_RECTIFY

When you update the unit details such as ingate, outgate, load, discharge, ramp, and deramp events for a container using rectify form.

Unit

UNIT_REEFER_FAULT

When the unit references fault code recorded. The event is recorded only if the fault code changed from the previous fault code.

Unit

UNIT_REEXPORT

When N4 creates a new export with the storage record of the import unit in the Chargeable Unit Events(CUE) while using Re Export form.

Unit

UNIT_RENUMBER

When the unit number is updated.

Unit

UNIT_REPAIRED

  • If the unit was previously undamaged and you record a new damage with a repaired date.

  • If you update an existing damage as repaired along with the other damage information such as width, depth, etc.

Unit

UNIT_REROUTE

When you update the routing for a unit.

Unit

UNIT_RESERVE

When unit reserved for an order (booking or EDO).

Unit

UNIT_RETIRE

  • Unit retired or in a Retired state

  • When you use the Re Export form, N4 retires the import units in the yard and Event is recorded.

Unit

UNIT_RETURN_TO_INBOUND_CARRIER

Records when the unit position updated to inbound carrier due to cancelation of direct delivery request. In other terms, returns a delivered unit on a truck to the yard.

Unit

UNIT_RETURN_TO_STORAGE

When you use the Return to Storage option to change an export or transship empty unit in the yard to a storage unit, and to remove the booking and routing information for the unit.

Unit

UNIT_ROLL

  • When split booking action is successful

  • When updating the booking for a pre-advised unit via the Configurable Pre-advise form or EDI

  • When unit changes rolled from BL

  • When you assign rail order for units

  • When unit is assigned to booking

Unit

UNIT_SEAL

When the unit seals are attached or updated.

Unit

UNIT_SHIFT_ON_CARRIER

When the unit is moved while on a carrier.

Unit

UNIT_SHUTOUT

An export unit planned to vessel remains in the yard even after vessel departed the terminal. Those unit are shut out units. There are other scenarios as well.

Unit UNIT_SHUTOUT (inbuilt) event will be triggered while updating the vessel visit phase from Departed to Closed. Below the condition/validations

  • Unit transit state should be in Yard

  • Unit should belong to the facility of vessel visit

  • Unit's OB Carrier visit should be same as vessel visit phase updating to Closed 

Unit

UNIT_SNX_UPDATE

When N4 successfully creates or updates a unit through SNX.

Unit

UNIT_SNX_UPDATE_REJECTED

When N4 encounters an error and cannot successfully update an existing unit through SNX.

Unit

UNIT_STORAGE_UPDATE

When you update the storage details for the selected unit in the Update Storage form.

Unit

UNIT_STRIP

1. When the unit is stripped or the goods are removed

2. After all the cargo lots are stripped from the unit.

3. When a break-bulk unit to track the goods stripped from an existing unit.

Unit

UNIT_STUFF

1.When you stuff goods with empty units.

2. When you stuff the contents of the selected break-bulk container into an empty unit.

Unit

UNIT_SWIPE

Event is recorded in the primary unit when the equipment is detached or goods transloaded from the unit.

Unit

UNIT_TBD_UNIT_MERGE

When you merge a TBD unit with an actual unit.

Unit

UNIT_TRANSFER_ALLOWED

When unit transfer at crane allowed after OCR reading. For N4 Automation, Crane Team UI records the Unit_Transfer_Allowed EC event (TROK) only if the unit is identified with BAPLIE. It does not record the event for orphaned containers.

Unit

UNIT_TRANSLOAD

When you use Transload Unit Form to transfer the contents of a full unit to an empty unit.

Unit

UNIT_TRANSLOAD_STRIP

When a full unit is retired in transload operation.

Unit

UNIT_TRANSLOAD_STUFF

When an empty unit is retired in transload operation.

Unit

UNIT_TRANSLOAD_TO_EMPTY

When N4 creates a new empty unit in transload operation.

Unit

UNIT_TRANSLOAD_TO_FULL

When N4 creates a new full unit in transload operation.

Unit

UNIT_TRUCKER_ASSIGNED

When you assign a trucking company to a unit.

Unit

UNIT_UNBUNDLE

When a container / chassis A and B are bundled in the yard and you remove / unbundle A from B via Unit Inspector, this event is recorded on container / chassis B.

Unit

UNIT_UNDO_DISCH

When the container discharge is reverted.

Unit

UNIT_UNDO_LOAD

When the loaded container is unloaded and sent back to the yard.

Unit

UNIT_VERMAS_EDI_CANCEL

When a unit is canceled because of VERMAS EDI is posted.

Unit

UNIT_VERMAS_EDI_CREATED

When VERMAS EDI is posted to create a container.

Unit

UNIT_VERMAS_EDI_REPLACE

When VERMAS EDI is posted to replace a container if it already exists.

Unit

UNIT_VERMAS_EDI_UPDATED

When VERMAS EDI is posted to update a container if it already exists.

Unit

UNIT_VGM_ASSIGNED

When the VGM is initially recorded for a unit either manually or through EDI.

Unit

UNIT_VGM_CANCEL

When the VGM is deleted for a unit either manually or through EDI.

Unit

UNIT_VGM_UPDATED

When the existing VGM is updated for a unit, either manually or through EDI.

Unit

UNIT_WANTS_POWER_NO

When the unit does not require power or power checkbox deselected in unit.

Unit

UNIT_WANTS_POWER_YES

When the unit requires power or power checkbox selected in unit.

Unit

UNKNOWN_DOOR_DIRECTION_ENCOUNTERED

When the unit Door Direction changed to an UNKNOWN position.

Unit

UPDATE_DELIVERY_RQMNTS

When you update the delivery requirements such as Trucking Company, Return Location, Destination, etc., for a unit.

Unit

 

You can refer this topic for details about events related to unit update actions.